Bottom     Previous     Contents

HTML

EasiWriter and TechWriter can load and save documents as HTML files (HyperText Markup Language).

HTML is not a page description language; it is one column of continuous text with embedded graphics. The page proportions and line breaks depend on the size of the monitor or window in which the page is viewed. If an HTML file is loaded into EasiWriter it is formatted to fit within the page margins, which is likely to be different from how the same document is displayed by an HTML browser.

To create an HTML document

HTML documents can be created using the Stationery pad HTMLStyles, or from a normal EasiWriter document.

  1. Create a new document after choosing HTMLStyles from The Stationery menu on the Icon bar and start a new document.

or

  1. Create/open an EasiWriter/TechWriter document.
  2. Choose HTML from the Save menu.

The document will be saved as HTML which can then be opened into a Browser or by EasiWriter itself.

Control of HTML output

There are a number of ways in which you can control the output of HTML generated by EasiWriter. These are documented in the section Advanced options.

Header level tags

The Header level tags <H1> - <H6> are determined by the level of the Chapter/Section.

If a document has Chapters and Sections the Chapter headings will be tagged <H1>, Section headings <H2>, first level Sub-sections <H3> etc. If the document only has Sections then the top level section will become <H1> and so on.

The Style names H1 - H6 in the HTMLStyles Stationery pad do not affect output levels but are used when importing HTML.

Multiple page HTML documents

EasiWriter can split large HTML documents into smaller ones. Page links are automatically created as is a contents page. This can be useful for producing on-line documentation such as this document.

Document are split where ever there is a page break and a contents list is generated using the Chapter, Section and Subsection headings. These headings are automatically turned into Anchors and are linked to their titles in the contents page.

Inserting the HTML document title

The contents of a header will be used as the document title when a document is saved as HTML.

<HEAD><TITLE>This text is in the document 
header</TITLE></HEAD>

To create a multi-page HTML document

  1. Insert page breaks at the point you want the document to be split.
    To do this is to choose On next page in the Section Format dialogue and organise your work into sections. Sections indicate where you want to start a new page and sub-sections are divisions of that page.
  2. Choose HTML from the Save menu and check Split at break .
  3. Edit the file name, leaving /html as the suffix and drag the file icon to a directory viewer.

EasiWriter will create a Table of contents page and a folder containing the individual pages. If there are any pictures (or equations - TechWriter) these will be converted into GIF's and put into an Images directory.

Editing user specified links

Note: If you have included your own anchors and links these will not work if the link points to a reference that has been moved to another page as part of the splitting process.

You will get a message such as 'The label label_name cannot be found on this page' or 'Tried to move to a non-existent label'.

Here are two ways of fixing an example HTML document where the document called Part00 contains:

<A HREF="#end_of_doc">Go to the end</A>

Which should link to an Anchor on the page called Part03

<A NAME="end_of_doc">end of doc</A>

Using !Edit

  1. Open the document that contains the Link (in this example Part00).
  2. Locate the link
    #end_of_doc
  3. Change it to
    Part03#end_of_doc

Using !HTML Edit

HTML Edit (v 4.24 and later) from RComp has the ability to detect links whose anchors have moved to other pages.

  1. Drag the document containing the link onto the !HTMLEdit icon on the Icon bar. The following dialogue will appear.
  2. Click YES and you will see a list of Invalid links.
  3. Click on the Link button of the link you want to fix.
  4. A dialogue will appear where you can drag the document containing the link (in this example Part03). The Link will be fixed.
  5. Click Update and Save the document from !HTMLEdit.

Next     Top